Welcome to BotSailor Help! Just use the email OTP to sign in and track your tickets. Password login isn’t needed anymore.

Manage Message Credits & AI Token Usage in BotSailor | Optimize Your Campaigns

Efficiently managing your messaging resources is essential to running cost-effective and high-impact chat campaigns. In BotSailor, Message Credits fuel your outbound broadcasts and individual messages, while AI Tokens power advanced AI-driven interactions. By tracking your usage of both resources, you can avoid unexpected overages, optimize your campaign strategy, and ensure seamless customer engagement.

 

What Are Message Credits & AI Tokens?

  • Message Credits
    Message Credits represent the number of WhatsApp, Facebook, Telegram, or webchat messages you’re allowed to send. Each outgoing message—whether a template, text, or media—consumes one or more credits based on WhatsApp’s billing rules or your BotSailor plan.

  • AI Tokens

    AI Tokens are units used when your chatbot calls BotSailor’s AI features (e.g., intent recognition, NLP responses, or custom AI workflows). Longer or more complex AI responses consume more tokens.

Why Track Usage?


  1. Cost Control
    Prevent unexpected charges by monitoring real-time credit and token consumption.

  2. Campaign Optimization
    Identify high-usage flows (e.g., AI-intensive sequences) and adjust messaging or AI prompts to reduce waste.

  3. Resource Planning
    Forecast your monthly needs knowing when to purchase additional credits or increase your AI token allotment.

  4. Performance Insights
    Correlate message volume and AI interactions with engagement metrics to fine-tune your customer outreach.



How to Monitor Usage in BotSailor

  1. Access the Dashboard

    • Log in to your BotSailor account.

    • Navigate to Dashboard from the left-hand menu.


  2. Locate the Usage Bar
    At the top of your Dashboard, you’ll see three key indicators:

    • Subscriber: current subscriber count vs. limit

    • Message: message credits used vs. total available

    • AI Token: AI tokens consumed vs. allocation

  3. Understand the Indicators

    • Green: usage below 50%

    • Orange: usage between 50%–80%

    • Red: usage above 80% (consider topping up)

    • Percentage Gauge: visual gauge showing how close you are to your limit.

    • Numerator/Denominator: exact numbers (e.g., 874/∞ for unlimited messages, or 64.8K/100.0K tokens).




      Color Coding
      :

      Green: usage below 50%
      Orange: usage between 50%–80%

      Red: usage above 80% (consider topping up)


  1. Drill Down for Details

  • Click on the Message or AI Token indicator to view a breakdown by channel (WhatsApp, Facebook, Telegram, Webchat).
  • Use date filters to analyze daily, weekly, or monthly usage trends.

  1. Export Usage Reports

  • In the Dashboard, scroll to the Reports section.
  • Select Usage Report and choose CSV or PDF format.
  • Schedule automated weekly or monthly reports to be emailed to your team.







Tips for Optimizing Your Usage

  • Batch Broadcasts: Schedule large broadcasts during off-peak hours to benefit from volume discounts or optimized routing.

  • Template Re-use: Consolidate message templates to reduce per-message credit consumption.

  • AI Prompt Efficiency: Craft concise AI prompts to limit token usage—shorter instructions usually consume fewer tokens.

  • Use Labels & Segments: Target only relevant subscribers to avoid sending unnecessary messages.

  • Set Alerts: Configure threshold alerts (e.g., 70% token usage) so you can top up resources before hitting limits.

  • Review Monthly: At each month’s end, audit your usage report to identify spikes and adjust future plans accordingly.

By actively monitoring your Message Credit and AI Token consumption, you’ll maintain better budget control, improve campaign performance, and leverage BotSailor’s full potential in delivering personalized, scalable messaging experiences.






FAQs 

What are Message Credits in BotSailor?
Message Credits are units that allow you to send messages via WhatsApp, Facebook, Telegram, or webchat. Each outgoing message (e.g., text, media, or template) consumes one or more credits based on WhatsApp’s billing rules or your BotSailor plan.

 

What are AI Tokens, and how are they used?
AI Tokens are units consumed when using BotSailor’s AI features, such as intent recognition, NLP responses, or custom AI workflows. More complex or longer AI responses use more tokens.

 

Why should I track my Message Credits and AI Tokens?
Tracking helps you:

  • Control costs by avoiding unexpected charges.

  • Optimize campaigns by identifying high-usage flows.

  • Plan resources by forecasting monthly needs.

  • Gain insights by correlating usage with engagement metrics.

 

How can I monitor my usage in BotSailor?
Log in to your BotSailor account, go to the Dashboard, and check the Usage Bar at the top. It shows:

  • Subscriber count vs. limit.

  • Message Credits used vs. available.

  • AI Tokens consumed vs. allocation.

 

What do the Usage Bar indicators mean?

  • Percentage Gauge: Shows how close you are to your limit.

  • Numerator/Denominator: Displays exact usage (e.g., 64.8K/100.0K tokens).

  • Color Coding: Green (<50%), Orange (50%–80%), Red (>80%, consider topping up).

 

Can I view detailed usage breakdowns?
Yes, click on the Message or AI Token indicator in the Dashboard to see usage by channel (WhatsApp, Facebook, Telegram, Webchat). Use date filters for daily, weekly, or monthly trends.


How do I export usage reports?
In the Dashboard’s Reports section, select Usage Report, choose CSV or PDF format, and export. You can also schedule automated weekly or monthly reports to be emailed.

 

What are some tips for optimizing Message Credit and AI Token usage?

  • Batch Broadcasts: Schedule large broadcasts during off-peak hours for discounts.

  • Template Re-use: Use consistent templates to reduce credit consumption.

  • AI Prompt Efficiency: Write concise AI prompts to save tokens.

  • Use Labels & Segments: Target specific subscribers to avoid unnecessary messages.

  • Set Alerts: Configure alerts for high usage (e.g., 70% token threshold).

  • Review Monthly: Audit usage reports to identify spikes and adjust plans.

 

What happens if I reach my Message Credit or AI Token limit?
When you approach your limit (above 80%, shown in red), you’ll need to top up resources to continue sending messages or using AI features. Set alerts to avoid interruptions.

 

 

How often should I review my usage?
Review your usage monthly by auditing reports to identify trends, optimize campaigns, and plan resource needs. Regular checks via the Dashboard also help maintain control.